home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Diamond Collection / The Diamond Collection (Software Vault)(Digital Impact).ISO / cdr13 / alist112.zip / ANSILIST.DOC next >
Text File  |  1995-03-14  |  8KB  |  191 lines
  1. ────╥───╖            ╓───────╖
  2.     ║   ╙╖   ╓─────╖╓╜ ╓─────╫──╖ ╓──╖    ╓─╖╓─────╖╓───────╖
  3.     ║    ╙╖  ║     ╙╢  ╙──╖  ║  ║ ║  ║    ║ ║║ ╓───╜╙─╖ ╓───╜
  4.     ║  ╓╖ ╙╖ ║      ╙╖    ╙─╖║  ║ ╙╖ ║    ║ ║║ ║      ║ ║
  5.     ║  ║╙╖ ╙╖║  ╓─╖  ╙╥──╖  ║║  ║  ║ ║    ║ ║║ ╙───╖  ║ ║
  6.     ║  ╙─╜  ║║  ║ ╙╖  ║  ╙╖ ║║  ║  ║ ║    ║ ║╙╖    ║  ║ ║
  7.     ║  ╓─╖  ╙╢  ║  ║  ║ ╓─╜ ║║  ║  ║ ╙───╖║ ║ ╙──╖ ║  ║ ║
  8.     ║  ║ ╙╖  ╙╖ ║  ║  ╟─╜ ╓─╜║  ║  ║     ║║ ║╓───╜╓╜  ║ ║
  9.     ║  ║  ╙╖  ║ ║  ║  ╟───╜  ║  ║  ╙─────╜╙─╜╙────╜   ╙─╜
  10.     ╙──╜   ╙─╥╜ ║  ║  ║      ╙──╜
  11.              ╙──╜  ╙──╜
  12.  
  13.  ANSILIST v 1.12     3.10.95
  14. ═════════════════════════════  by Walter Gamba
  15.  
  16. ANSILIST is a small, but fast, text viewer. It has, as one can guess from the
  17. name, ANSI capabilities, i.e. it can display text with embedded ANSI escape
  18. sequences. It does not need ANSI.SYS, of course.
  19.  
  20. It can also interprete smaller color escape sequences
  21. (see "Why my simple color coding scheme").
  22.  
  23. ANSILIST is shareware, but cheap. Pleas read the Shareware notice.
  24.             ─────────
  25.  
  26.  file list
  27. ───────────────
  28. Your ZIP file must contain the following:
  29. ANSILIST.EXE    the exe file
  30. ANSILIST.DOC    this doc
  31. COLRTEXT.COL    a sample color file (not ANSI),which is COLORTXT's doc file!
  32. HUNGBOOK.COL    an ANSI test file
  33.  
  34.  Note about COLORTXT
  35. ─────────────────────
  36. COLORTXT is a companion to ANSILIST, and besides offering all the facilities 
  37. offered by ANSILIST, it adds the ability to paint text.
  38. Since COLORTXT is currently ver 0.98 I have not yet uploaded it to SimTel. 
  39. Should you be interested in trying it, just mail me.
  40.  
  41.  
  42.  HOW TO RUN IT
  43. ───────────────
  44. To run ANSILIST simply type on the command line:
  45. >>ANSILIST filelame [/t] [/c]
  46.  
  47. "filename" is the name of the file you want to list. It can list files with up
  48. to 650,000 lines..
  49.         /t      will force ANSILIST to start in plain text mode (by default it
  50.                 starts in ANSI mode).
  51.         /c      will force it to start in ClearScreen mode (by default
  52.                 the ClearScreen mode is turned off).
  53.  
  54. ANSI mode: the ability to read end interprete ansi escape sequences.
  55.            when it is turned off ansi escapes are treated as normal text.
  56. ClearScreen mode: in this mode, before every screen update, the program will
  57.                   wipe off the screen. If this is turned off it won't.
  58. Read the ANSI section for details.
  59.  
  60. Typing ANSILIST alone will bring up a concise help.
  61.  
  62. ANSILIST Screen:
  63. ────────────────
  64. You will be presented with the first page of the document.
  65. At the bottom of the screen a Status Bar will contain (from right to left):
  66.  
  67.         -the name of the file you're viewing
  68.         -the Ansi status          (read the Ansi section)
  69.         -the Clearscreen status   (read the Ansi section)
  70.         -the number of the line displayed in the upper row of the screen
  71.         -the percentage of the text yo've already viewed (including the current
  72.                                                           page)
  73. Commands:
  74. ─────────
  75. While viewing a text you can use the following keys:
  76.  
  77. SPACE/ENTER/PGDWN       view next page
  78.              PGUP       view previous page
  79.  
  80.              HOME       moves to the beginning of the file
  81.               END       moves to the last page of the file
  82.  
  83.               DWN       view one line down
  84.                UP       view one liine up
  85.  
  86.              LEFT       view current page, one char to the left
  87.             RIGHT       view current page, one char on th right
  88.  
  89.                 A       toggle ANSI(& color) capability on/off
  90.                 C       toggle ClearScreen status
  91.  
  92.            Only Registered version:
  93.                 F       find a string in the file, from current position.
  94.                         matches ignoring case.
  95.                 N       find next occurrence of the string
  96.  
  97.                 L       load another file
  98.  
  99.  
  100.            In both versions:
  101.  
  102.               ESC       quit ANSILIST
  103.  
  104. When prompted with error messages hit a key to resume.
  105.  
  106. ANSILIST & ANSI files.
  107. ──────────────────────
  108. The texts this program was at first intended to work with were text files
  109. with ANSI esacape sequeneces which specified colour. This kind of text is
  110. very much similar to plain text, i.e. one line in the file corresponds to
  111. exactly one line on the screen. When I decided to implement all the other
  112. escape sequences, in order to be able to view ANSI drawings, I had some
  113. problems, mainly because an ansi file has not a one-to-one mapping between
  114. file lines and screen lines.
  115. When viewing large ansi file I suggest to use only the PGUP/PGDWN keys,
  116. since in an ansi file with embedded screen coordinates it is rarely effective
  117. to read the next file line hoping to see the drawing scrolling one line.
  118. This is because usually in ansi files it takes several lines in the file to
  119. specify one line on the screen.
  120. Moreover, since ansi drawing is not sequencial, but can move the cursor
  121. everywhere, sometimes portions of the screen are left untouched (and
  122. supposed black). Since we are using a text viewer, the screen is always
  123. covered with characters and rarely empty. That's why I included the option
  124. of clearing the screen before any screen update( i.e. before any movement
  125. command). One can toggle this function on and off with the C key.
  126. This function is useless when viewing files in plain text mode.
  127.  
  128. Why an ANSI file viewer?
  129. ────────────────────────
  130. I was bored to use "type moo.ans" to view files with ansi escapes. When I
  131. discovered GnuAWK and used it to colour up some text, I needed one to check
  132. my work easily, scrolling up and down etc..
  133. I include a Monty Python's sketch -The Hungarian Phrasebook-, coloured so as
  134. to be more readable,as a test of the capabilities of this tiny software.
  135. Should you be interested, I have some little GAWK script able to turn a
  136. screenplay in a coloured screenplayin many ways. Just E-Mail me.
  137.  
  138. Why my simple colour coding scheme
  139. ──────────────────────────────────
  140. I included in ANSILIST, and in the new COLORTXT,the ability to interprete
  141. a simpeler color coding scheme, consisting of two bytes, one for the escape,
  142. the other for the color attribute. It was much more simple and faster to
  143. handle files this way.
  144. The escape sequence is made of two bytes: 0x01 ATTR
  145.         where ATTR is a screen color attribute (as used in the Video Ram )
  146.         ored with 0x80.
  147.         if ATTR is 0xFF this escape sequence will restore the colour used
  148.         before the previous `normal' escape sequence.
  149. Should you be interested, I have developed COLORTXT, a small program wich
  150. includes all the facilities present in ANSILIST, plus the ability to "paint"
  151. text files. Search for CTEXTxxx.ZIP.
  152.  
  153.           BUGS REPORT
  154.  ──────────────────────────────
  155. Since this is my first release, it is possible that my program has some bugs.
  156. Even if you are not registered, it would be very useful to report any bug
  157. to me (possibly via E-Mail). Thanx.
  158.  
  159.         SHAREWARE NOTICE
  160.  ──────────────────────────────
  161. This program is not free, since it has costed me some (light) work finding
  162. out how the hell Ansi really works...
  163. If you keep on using it after a trial period of 23 days tou should register.
  164. To register just send me a Self Adressed Stamped (enuff stamps to allow shippage
  165. of a floppy diisk...) envelope with 5$ (French Francs and Italian Lire of the
  166. roughly same value are OK).
  167. It is a small fee, but it will help me improve ANSILIST and my many other.
  168. projects. Remember to specify if your computer can read 720K disks (which
  169. are cheaper :) ). I will ship you the disk with the registered version which
  170. include some facilities not implemented in the shareware version.
  171.  
  172.        REDISTRIBUTION
  173.  ─────────────────────────
  174. You may freely redistribute this software as long as you don't alter it and you
  175. keep the ZIP package unaltered. All disclaimers and legal stuff as usual...
  176.  
  177. My address is:
  178.         Walter Gamba
  179.         via Torricelli 36
  180.         10129 Torino
  181.         ITALY
  182.  
  183.         E-Mail: IPER1@pol90a.polito.it
  184.  
  185.         ╒═╕╒═╕╒═══╕╒═╤═╕   ╒════╤═══╕╒═╕╒═══╕  ╒═╕
  186.         │ ╘╛ ╞╛╒═╕╘╡ │ │   │ ╒══╡ ╒╕╘╡ ││ ═╤╛  │ │
  187.         │    │ ╘═╛ │ │ ╘═╕ │ ╘═╕│ ╘╛╒╡ │╘═╕╘╕  │ │
  188.         │ ╒╕ │ ╒═╕ │ │   │ │  ═╧╡ ╒╕╘╡ ╞══╛╒╛  ╞═╡
  189.         ╘═╛╘═╧═╛ ╘═╧═╧═══╛ ╘════╧═╛│ ╞═╧═══╛   ╘═╛
  190.                                    ╘═╛
  191.